home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / intuition / powersnap_2.1b / powersnap.doc < prev    next >
Text File  |  1994-11-17  |  35KB  |  902 lines
  1.  
  2.  
  3.      
  4.  
  5.  
  6.                            PowerSnap 2.1b User Manual
  7.  
  8.                                   Nov 22, 1992
  9.  
  10.  
  11.  
  12.      PREFACE 
  13.  
  14.         The programs   and   files   in   this   distribution   are  freely
  15.      distributable,  but  are also Copyright (c) Nico Francois. They may be
  16.      freely  distributed  as  long as no more than a nominal fee is charged
  17.      to cover time and copying costs.  
  18.         No commercial  usage  is  permitted without written permission from
  19.      the  author. Everything in this distribution must be kept together, in
  20.      original unmodified form.  
  21.         The above is generally known as freeware.  
  22.  
  23.         If you  have  suggestions  or remarks about this program, or if you
  24.      find any bugs, please let me know.  
  25.  
  26.         Contacting the author: 
  27.  
  28.           Fido:  2:292/603.10 (Nico Francois)
  29.  
  30.           UUCP:  Nico.Francois@p10.f603.n292.z2.FidoNet.Org
  31.  
  32.           Mail:  Nico François
  33.                  Corbielaan 13
  34.                  B-3060 Bertem
  35.                  BELGIUM
  36.  
  37.         If you  can  please use e-mail. That way you'll stand a much better
  38.      chance of getting a reply quickly.  
  39.  
  40.         NOTE: PowerSnap  2.1b  requires  Kickstart  and  Workbench  2.0  or
  41.      higher to run! 
  42.  
  43.  
  44.      1. Introduction 
  45.      --------------- 
  46.  
  47.         Snap, snap,  snap,  snap, eggs and snap :-)  Ahem...  (If you don't
  48.      get  this  don't  let  it bother you if you think I've gone completely
  49.      bananas :-) 
  50.  
  51.         PowerSnap is  a  utility  that  allows you to use the mouse to mark
  52.      characters  anywhere on the screen and paste them somewhere else, like
  53.      in  the  CLI  or in a string gadget. PowerSnap will check what font is
  54.      used  in  the  window  you snap from and will look for the position of
  55.      the  characters  automatically.  It  recognizes  all  non proportional
  56.      fonts  of  up to 24 pixels wide and of any height so this should cover
  57.      most  fonts  used.  Snapping and pasting text is done using the mouse,
  58.  
  59.  
  60.                                      Page 1
  61.  
  62.  
  63.      
  64.  
  65.  
  66.      making PowerSnap fast and easy to use.  
  67.         To try  PowerSnap out, double-click its icon, move the mouse over a
  68.      character  on  the  screen,  press  the left Alt key and while keeping
  69.      this  pressed  press  the  left  mouse  button.  After  a  short delay
  70.      (depends  on  how  big  the  font  is) PowerSnap will either flash the
  71.      screen,  indicating  it  hasn't found a character at this position (it
  72.      is  possible  PowerSnap  didn't  look  for  the  correct font), or the
  73.      character  you  are pointing at will be selected. Move the mouse while
  74.      keeping  the  left  Alt  key  and the mouse button down to select more
  75.      characters.  Once  you  are  satisfied  with  what  you  have selected
  76.      release  the  left  Alt key. You can now insert the text you have just
  77.      snapped  by  pressing  either  left  Alt + V or left Alt + right mouse
  78.      button.  
  79.         Both the   left  Alt  and  the  V  keys  mentioned  in  this  short
  80.      explanation   are   user-definable  (see  below).  Also,  don't  start
  81.      snapping  on  a  space because PowerSnap will almost certainly get the
  82.      character  positions  wrong.  You CAN start snapping on a space if you
  83.      have already snapped in the window.  
  84.         New to  PowerSnap  2.1  is the ability to keep a history of snapped
  85.      strings.  You may select from this history to re-paste something.  
  86.  
  87.  
  88.      2. Installation 
  89.      --------------- 
  90.  
  91.         To install  PowerSnap  automatically use the installation script or
  92.      install  the  handler  manually by copying 'PowerSnap-handler' to your
  93.      L:  directory.   'PowerSnap-handler'  does not have to be in L: but it
  94.      is  best  if you put it there, PowerSnap will also find it if it is in
  95.      the current directory.  
  96.         If you  want  PowerSnap  to be part of your initial startup (so you
  97.      always  have  the comfort of snapping anything anywhere :-) you should
  98.      put  a simple line saying 'PowerSnap' in your 's:user-startup'. If you
  99.      wish  to  specify  options  include  these  on the same line, like for
  100.      example  'PowerSnap  SMARTSPACE  COLOR  2'.  To  disable the copyright
  101.      message redirect output to NIL: like in 'PowerSnap >NIL:'.  
  102.         Workbench 2.0  users have the following extra possibility: drag the
  103.      PowerSnap  icon into the WbStartup drawer of your boot disk/partition.
  104.      And  that's  all  there  is  to  it.  Specify  options  in  the icon's
  105.      tooltypes (you will want to set the tooltype 'CX_POPUP=NO').  
  106.         In any case make sure PowerSnap is in your command path! 
  107.  
  108.  
  109.      3. Usage 
  110.      -------- 
  111.  
  112.      3.1 From CLI or Shell 
  113.  
  114.         Enter 'PowerSnap  ?' for a CLI usage template, 'PowerSnap ??' for a
  115.      more detailed usage report.  
  116.  
  117.  
  118.  
  119.  
  120.                                      Page 2
  121.  
  122.  
  123.      
  124.  
  125.  
  126.         Explanation of the options: 
  127.  
  128.      CX_PRIORITY n  : Set priority of commodity (default: 0).  
  129.  
  130.      CX_POPUP YES|NO: Set to NO to not open GUI window when PowerSnap is
  131.                       first installed (default: YES).  
  132.  
  133.      CX_POPKEY desc : Standard description of hotkey to pop up GUI window
  134.                       (default: control lalt p).  
  135.  
  136.      NOGUI          : Don't open GUI settings window.  
  137.  
  138.      QUAL qual      : Set snap qualifier (default: lalt). This is the
  139.                       qualifier that must be down when you press the left
  140.                       mouse button to start snapping. This is also the
  141.                       qualifier for inserting the snapped text. There are
  142.                       two ways to insert snapped text: using the paste key
  143.                       or using the right mouse button.  
  144.  
  145.      SLQUAL qual    : Set single line paste qualifier (default:
  146.                       lalt+lshift). When this qualifier is down and you
  147.                       insert snapped text everything will be put on one
  148.                       single line.  All whitespace (spaces and newlines)
  149.                       between words will be changed to a single space.
  150.                       Very useful for inserting a lot of filenames from a
  151.                       directory for example.  
  152.  
  153.      MULTIQUAL qual : Set multisnap qualifier (default: lalt+lshift). When
  154.                       you start snapping with this qualifier the snapped
  155.                       text will be appended after what you snapped before.
  156.                       A newline will be placed in between the snapped
  157.                       texts, so they are all on their own line. Paste
  158.                       snapped text using the single line qualifier to get
  159.                       everything on one line. Note that the default single
  160.                       line qualifier and the multisnap qualifier are the
  161.                       same. You can still toggle multisnap on or off when
  162.                       you are already snapping. Just change the qualifier,
  163.                       so in the default setup let go or press down the
  164.                       shift key. There is a small delay of 1/8 sec before
  165.                       toggling the snap mode. This was done so it is less
  166.                       likely that you accidently snap in the wrong mode
  167.                       when you release all qualifiers to stop snapping.  
  168.  
  169.      PASTEKEY c     : Set pastekey (default: V). This key is used to
  170.                       insert the snapped text. Insertion will follow when
  171.                       it is pressed with one of the three possible
  172.                       qualifiers down (QUAL, SLQUAL, PAQUAL).  
  173.  
  174.      SNAPCHARS      : Start with character snap (default).  
  175.  
  176.      SNAPFRAME      : Start with frame snap. PowerSnap has two snap modes:
  177.                       character and frame.  The easiest to explain is
  178.  
  179.  
  180.                                      Page 3
  181.  
  182.  
  183.      
  184.  
  185.  
  186.                       frame snap, you just draw a rectangle and everything
  187.                       inside it will be snapped. Character snap will
  188.                       interpret the screen as lines of text (like an
  189.                       editor) and will snap accordingly.  
  190.  
  191.      [NO]JOIN       : Join mode on/off (default: JOIN). Tells PowerSnap if
  192.                       it's ok to join two